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* The MOREX interface re-born: 


3 ey z oe 
. Good: products never die! The printer 
interface which Dave and I designed in 
1982 and which is STILL the only 
interface supporting both Centronics and 
bi-directional RS 232, is alive again 
due to popular demand. (It also provides 
a through port and therefore KDOS users 
can plug their disk interface onto its 
back without an extender cable.) 

It is supplied with a configuration 
program allowing you to customise for 
your printer (for screen dumps, CR/LF, 
split baud rates, line and page lengths) 
The same program will. give screen dumps 
on a large variety of dot-matrix 
STAR, 
NEC, RITEMAN etc and once configured it 
can be saved on tape for further use. 


If you buy this interface you will be 


sent. a SPDOS/KDOS compatible cassette 


_which-will enable them to save both 6 


configuration and the configured 
programs on disk., 
Unfortunately, being a born-again 


product it has suffered from some 
teething problems ..with our having to 
organise all aspects of component 
sourcing, production etc. I offer my 
humble apologies to those of you who 
sent: us orders as far back as September 
and’ have only just received the goodies. 


“price f. £45. including a Centronics 
. cable, VAT and’p&p. It is not compatible 


with the TIMEX 2068۰ 


* Making SPDOS a CP/M for the Spectrum: 
(CP/M is a registered trademark of 
Digital Reséarch Inc) 


* The Disk situation in the Spectrum 
scene is, to say the least, confusing. 
Meny companies designed disk systems of 
sorts only to find that they were 
rapidly driven out of business by better 
or better marketed systems. Apart from 
SPDOS and KDOS, there are two or three 
rather persistent companies with 
enormoys marketing clout who have been 


marketing»-middle-of-the-road . systems 


8 


Imagine و"‎ Disk Operating System that 
can be booted up on any Spectrum Disk 


hardware environment by using a suitable 


` diskette and can then create a SPDOS 


software environment where ALL programs 
written . or modified for SPDOS can 


. printers such as EPSON, SEIKOSHA, 


...and- so the» tabs part. to reveal 
another SURFnews, another episode in the’ 
life of simple disk folk. First an 
apology. SURFnews is advertised as 
being quarterly but isn't quite making 
it at present, averaging four months 
> Never fear, you're 
getting the same amount of info. In the 
process your editor/publisher is fast 
becoming Jiminy Cricket to Abbeydale's 
Pinocchio, sitting telephonicly on their 
shoulder. and saying "It's time for 
another. SURFnews!" I still prefer the 


:. relaxed competence of Abbeydale to any 


sort of frenetic timekeeping. At least 
that way you know that the quality is 
assured! Edat ۲ 

Dimitri. wrote mogt of this SURFnews; 
Dave is out‘of hospital and pretty much 
back to normals Dimitri left out a few 
items of interest, though. You can now 
contact Abbeydale Designers on, Prestel, 
their mailbox number being ۰ 
Dimitri has designed and is using (as am 
I, thanks to big D) a mod to, the VIX5000 
modem, the most popular of the Spectrum 


modems, which allows you to use the. 


SPDOS/KDOS interface. At last you can 
use some of Dave’ Gorski's enhancements 
to the VIX software without waiting ages. 
for it to load. You can also save 
stacks of screens and (not least of the 
advantages) saye wear and tear on the 
edge connector. Dimitri has also sorted 
out some rather nifty routines which 
enable you to run a printer interface at 
the same time., If you want more details 
of this modification, 
addressed envelope and £1 
Designers, PO Box 124, Reading, 
RG4 OLF and you will get a 
outlining the mod with a circuit diagram 
of a small additional board you have to 
make up and instructions on fitting it. 
Fron the same address you can get a disc 
with SPDOS1.2 for £15 or the same with a 
host of extra utility programs and an 


excellent FORTH implementation for £30 - 
(see elsewhere in this SURFsews for, more»: =m 001 
3 هت‎ + witmvariet success. 


details). 


currency other than Sterling, please 
allow some extra for the bank handling 
charges. For instance the SPDOS1.2 disk 
with utilities costs $60. Add extra for 
posting if you want it sent airmail. 


between issues. 


the . 


the mean time they carry on selling 
their wares on the medium supported by 
all Spectrums: cassette tape. A CP/M 
like situation will enable them to make 
a universal version of their programs 
available to the disk-using public This, 
makes both financial and 
broadens 
software base available to SPDOS and 
other users. SURF will then open up to 
thousands more users who might be using 
different sorts of hardware on their 
Spectrums but have one thing in common: 
SPDOS. ` a. 


We are already working on 6 
adaptations and we will keep you poste 
as we go along. 


سم عم مو مه سم غو مو سا مم مت وم مس کے ست س ست کت هم وم وم موو وو کے هو وو وو س وو مو ټم 


disk and clears memory. Reloadi the 
information places the bytes at VARS+6 
and is SAVEd from there once again using 
the count. ۱ 

A prompt is given at the. appropriate 
point to place the word-processing 
program in the drive. The final file is 
saved on the WP disk and can be loaded 
from tasword II in the conventional 
manner with the filename "output". 

The disassembled program is now ready 
for editing. Enjoy! 


10 PRINT #4: OPEN #5, "OUTPUT" 

20 DIM C$ (10000) 

25 GOTO 90 

30 DIM C(2): LET C(1)=1 

40 IET 0$(C(1))= INKEYS #5 

50 IET C(1)=C(1)+1 

60 GOTO 40 

100 PRINT #4: CLOSE #5 

110 LET C(1)=C(1)-1 

120 LET C(2)=C(1)*2 

130 DIM W$(C(2) ( 

140 FOR 1-0-10 C(1)-1 STEP 32 

150 LET W=I*2 

160 IET WS(W+1 TO W+64)=C$(I+1 TO 1+32) 
170 NEXT I 

180 FOR I=1 TO 10: BEEP .1,20: NEXT I 
190 PRINT "Change to WP disc" 


200 PAUSE O 

210 PRINT #4: SAVE "OUTPUT"DATA WS() 
220 PRINT #4: SAVE "COUNTS"DATA C() 

230 CLEAR 

400 PRINT #4: LOAD "OUTPUT"DATA WS() 
410 PRINT #4: LOAD "COUNTS"DATA C() 


500 PRINT #4: SAVE "output"CODE PEEK 
23627+256*PEEK 25628۷6 ,C(2) 


. Of course, 
` marketing sense and 


operate in full. After all, that's what 
happens when a KDOS user boots up with a 
SPDOS system disk in drive 1! g 


As in CP/M, the Input/Output primitives 


(the 'BIOS') will be different for each 
piece of hardware but as long as the. DOS 


is accessed via the usual 'PRINT #4:' in. 


BASIC or the Hook Code -structure in 
machine code, compatibility. will be 
guaranteed. 


Now, this will obviously enhance these 


other disk systems but what .is the 
benefit to SURF members? 

To start with, a universal Disk 
Operating System will overcome the 
justified reluctance of software houses 
to write for disk. They have. all been 
waiting for the dust to settle and in 


سم سے مر مت مه موم و مه ماش سو سوه وم دوو همو وم مو سات کے سے es‏ ست کے ست وښو مو کے ټوو ee‏ سے وه سے 


PRINTER TO TEXT 
(for TS-2068) 
Munson H. Cockayne Jnr, 


This program is used to create 
tasword II (Tasman Software) compatible 
files from disassembled output from HOT 
2 (Ray Kingsley) to enable adequate 
documentation of assembly language 
programs. Since HOT Z is based on a 32- 
character wide screen: (like many 


programs for the TS-2068) there is not | 


enough room for comments and no provis- 
ion is made for them. By using the 
following instructions and program one 
can create a file that can be loaded 


into tasword II and edited with added ` 


tomments. 

First you must load the machine code 
portion of the program by itself or 
delete the program and , clear the 
variables to make room for the RAM- 
resident portion of a sequential file. 
Next create the sequential file by 
"PRINT #4: OPEN #3,"Output". Return to 
the machine call and set the appropriate 
values to END and CURSOR. Now enter 
assembly mode and give the LLIST command 
to send the disassembled code to the 
"printer". Exit to BASIC and "PRINT #4: 
CLOSE #3". 

Now load and RUN the program below 
which will read out the file into ۰. 
A count is maintained so that an _incre- 
ment of 32 is done at every 32 
characters read in. This count. is also 
used to DIM WS to the exact 8126 64 
The program stores the information on 


read/write head rest between (!) tracks 
which makes the DOS report things like 
"Record not found" when you attempt 
simple things like 'CAT' or 'LOAD'. This 
normally happens when a drive is 
selected for the first time (if it is a 
second drive) or when it is re-selected. 
A simple remedy (other than getting hold 
of some decent drives...) is to type: 
QUT 229,3 

which places the head on.a known track 
(zero): and makes subsequent operations 
possible. 


* A word of apology to you if you are 
not yet perfectly familiar with machine 
code mumbo-jumbo and found my "block 
move ' instructions in SURFnews1 
confusing. The codes given apply to the 
particular case 1 described: a 
hypothetical machine code program 
normally starting at 50000 and being 
15000 bytes long. In a more ‘general 
purpose' form the block move program 
would look like this: 


33, al, a2, 17, b1, bey ty ety C2; 251, 
134, 195, 41, 2 


where al, a2 correspond to the address 
of the last byte of the relocated block; 
b1, b2 give the length of the block; 


` c1,c2 correspond to the 'real' last byte 
“address and d1, 


d2 correspond to the 
execution address. 

To work out these numbers for different 
programs run the following lines: 


10 INPUT "Address:";a 3 
20 LET a2=INT(a/256): LET at=a-256*a2 
30 PRINT "al=" jal '"a2=";a2 


eg let 2=55000, then a2=INT(55000/256)= 
214 and al=55000-214*256=216. 


* Making better use of the single code 
filenames is the next topic in the 


agenda: 


As you no doubt remember, SPDOS/KDOS 
allows BASIC and machine code programs 
to be loaded and run without using the 
keyword 'LOAD' (SURFnews1). You should 
also recall that a machine code program 
loaded this way auto-runs from the first 
memory location it occupies. This is 
extremely useful as it eliminates the 
need for clumsy 'RAND. USR ' and makes 
these programs behave just like SPDOS 
commands. 


1 


and’ 


THE SURF TECHNICAL CORNE 
(Dmitri speaks...) >. 


I am back again folks and may the Force 
(SPDOS that is) be with you. There are 
so many things to tal about in this 
Newsletter I find it difficult} to choose 
what to start with! 


* First of all, I would like to say a 


few things to the newcomers of this 
brotherhood, namely the KDOS- users. We 
designed the Kempston System (KDOS) with 
SPDOS compatibility in mind. SPDOS has 


gained a great deal of respect in the | 


Spectrum scene because of its high 
degree of sophistication, user 
friendliness, speed, “capacity, support 
etc. and, therefore, we shall carry on 
developing utilities and upgrades for 
it. As you know, enhanced: versions of 
the Operating System are already 


becoming available from us on disk, ` 


making SPDOS an ever expanding system. 
The great thing about KDOS is that 
booting it up with a SPDOS system disk 
in drive 1 automatically creates a SPDOS 
environment (including the memory 
overhead, of course!) and hence , 
everything that works on SPDOS works 
with KDOS as well! (In fact, a KDOS in 
SPDOS clothing may operate faster than a 
the 


‘pure' KDOS system because 
ROM-switching overhead no . longer 
exists.) 


* Now, down to problems: 


* Some of you have experienced problems 
with INK, PAPER etc commands following 
disk operations (read: the letter from 
Trevor Judd for details). The reason is 
that these commands don't seem .to open 
the screen channel by default 
therefore the stream which was used last 
is assumed. Trying to handle a. screen 
command via the disk channel is 
definitely NOT the 96 thing! 
Fortunately, 'PRINT' automatically makes 
stream 2 and its attached channel the 
‘current! stream and so using ‘PRINT’ 
(if you don't mind a line-feed) or 
'PRINT;' (if you do) will eliminate the 
problem. 


* TEC drives, usually supplied by 
Cumana, are very quiet and quite cheap. 
They can also be nasty and a bit 
unreliable. Some of them have the habit 
of -occasionally- letting their 


the . 


the mean time they carry on selling 
their wares on the medium supported by 
all Spectrums: cassette tape. A CP/M 
like situation will enable them to make 
a universal version of their programs 
available to the disk-using public This, 
makes both financial and 
broadens 
software base available to SPDOS and 
other users. SURF will then open up to 
thousands more users who might be using 
different sorts of hardware on their 
Spectrums but have one thing in common: 
SPDOS. ` ee te 


We are already working on the 
adaptations and we will keep you poste 


as we go along. : 
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disk and clears memory. Reloadi the 
information places the bytes at ARS+6 
and is SAVEd from there once again using 
the count. 

A prompt is given at the. appropriate 
point to place the word-processing 
program in.the drive. The final file is 
saved on the WP disk and can be loaded 
fron tasword II in the conventional 
manner with the filename "output". 

The disassembled program is now ready 
for editing. Enjoy! 


10 PRINT #4: OPEN #5, "OUTPUT" 
20 DIM C$ (10000) 
25 GOTO 90 
50 DIM C(2): IET C(1)=1 
40 LET C$(C(1))= INKEYS #5 
50 LET C(1 )=C(1(+1 
0 GOTO 0 
100 PRINT #4: CLOSE #5 
410 LET C(1)=C(1)-1 
120 IET C(2)=C(1)*2 
130 DIM WS(C(2)) 
140 FOR 120 TO C(1)-1 STEP 32 
150 LET 2 
160 LET WS(W+1 TO W+64)=C$(I+1 TO 1+32) 
170 NEXT 1 
180 FOR I=1 TO 10: BEEP .1,20: NEXT I 
190 PRINT "Change to WP disc" 


200 PAUSE O 

210 PRINT #4: SAVE "OUTPUT"DATA ۷) ( 
220 PRINT #4: SAVE "COUNTS"DATA Gt) 
230 CLEAR 

400 PRINT #4: LOAD ۵۸ ۷5)( 
410 PRINT #4: LOAD "COUNTS"DATA CC): 


500 PRINT #4: SAVE “output"CODE PEEK 
2362 7+256* PEEK 23562816 ,0)2( 


. Of course, 
` marketing sense and 


operate in full. After all, that's what 
happens when a KDOS user boots up with a 
SPDOS system disk in drive 1! 


As in CP/M, the Input/Output primitives 


(the 'BIOS') will be different for each 
piece of hardware but as long as the DOS 


is accessed via the usual 'PRINT #4:' in, 
Code .structure in. 


BASIC or the Hook 
machine code, compatibility. will be 
guaranteed. 

Now, this will obviously enhance these 
other disk systems but what 18 6 
benefit to SURF members? 

To start with, a universal Disk 
Operating System will overcome the 
justified reluctance of software houses 
to write for disk. They have. all been 
waiting for the dust to settle and in 
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PRINTER TO TEXT 
(for TS-2068) 
Munson H. Cockayne Jnr, 


This program is used to create 
tasword II (Tasman Software) compatible 
files from disassembled output from HOT 
Z (Ray Kingsley) to enable adequate 
documentation of assembly language 
programs. Since HOT 2 is based on a 32- 
character wide screen: (like many 
programs for the TS-2068) there is not 
enough room for comments and no provis- 
ion is made for them. By using the 
following instructions and program one 
can create a file that can be loaded 


into tasword II and edited with added ` 


tomments. 

First you must load the machine code 
portion of the program by itself or 
delete the program and , clear the 
variables to make room for the RAM- 
resident portion of a sequential file. 
Next create the sequential file by 
"PRINT #4: OPEN #3,"Output". Return to 
the machine call and set the appropriate 
values to END and CURSOR. Now enter 
assembly mode and give the LLIST command 
to send the disassembled code to _ the 
"printer". Exit to BASIC and "PRINT #4: 
CLOSE #3". x ok 

Now load and RUN the program below 
which will read out the file into ۶۰ 
A count is maintained so that an . incre 
ment of 32 is done at every 32 
characters read in. This count. is also 
used to DIM W$ to the exact size needed. 
me program stores the information on 


read/write head rest between )!( tracks 
which makes the DOS report things like 
"Record not found" when you attempt 
simple things like 'CAT' or 'LOAD'. This 
normally happens when a drive is 
selected for the first time (if it is a 
second drive) or when it is re-selected. 
A simple remedy (other than getting hold 
of some decent drives...) is to type: 
-OUT 229,3 

which places the head ده‎ a known track 
(zero) and makes subsequent operations 
possible. 


* A word of apology to you if you are 
not yet perfectly familiar with machine 


code mumbo—jumbo and found my ۵ 
move ' instructions in SURFnews1 
confusing. The codes given apply to the 
particular case 1 described: a 
hypothetical machine code program 


at 50000 and being 
15000 bytes long. In a more ‘general 
purpose' form the block move program 
would look like this: 


33, Gt, 2, 17, وان‎ Dey ږا‎ ety CE و‎ 


184, 195, d1, 2 


where al, a2 correspond to the address 
of the last byte of the relocated block; 
bi, 02 give the length of the block; 


` c1,c2 correspond to the 'real' last byte 
‘address and d1, 


d2 correspond to 6 
execution address. 

To work out these numbers for different 
programs run the following lines: 


10 INPUT "Address:";a ۱ 
20 LET a2=INT(a/256): LET al=a-256*a2 
50 PRINT “al=";a1 "a2=";a2 i 


eg let a=55000, then a2=INT(55000/256)= 
214 and al=55000-214*256=216. 


* Making better use of the single code 
filenames is the next topic in the 


agenda: 


As you no doubt remember, SPDOS/KDOS 
allows BASIC and machine code programs 
to be loaded and run without using the 
keyword 'LOAD' (SURFnews1). You should 
also recall that a machine code program 
loaded this way auto-runs from the first 


memory location it occupies. This is 
extremely useful as it eliminates the 
need for clumsy 'RAND. USR ' and makes 


these programs behave just like SPDOS 
commands. 


normally starting 


٢ 


in the >- 


and’ 


THE SURF TECHNICAL CORNER ` 
(Dmitri speaks...) 


I am back again folks and may the Force 
(SPDOS that is) be with you. There are 
so many things to talk about in this 
Newsletter I find it difficult to choose 
what to start with! 


* First of all, I would like to say a 


few things to the newcomers of this 
brotherhood, namely the KDOS: users. We 
designed the Kempston System (KDOS) with 
SPDOS compatibility in mind. SPDOS has 
gained a great deal 08 757 


Spectrum scene because of its high 
degree of sophistication, user 
friendliness, speed, "capacity, support 


etc. and, therefore, we shall carry on 
developing utilities and upgrades for 
it. As you know, enhanced: versions of 
the Operating System are already 
becoming available fron us on disk, 
making SPDOS an ever expanding system. 
The great thing about KDOS is that 
booting it up with a SPDOS system disk 
in drive 1 automatically creates a SPDOS 
environment (including the memory 
overhead, of course!) and thence, 
everything that works on SPDOS works 
with KDOS as well! (In fact, a KDOS in 
SPDOS clothing may operate faster than a 


‘pure' KDOS system because the 
ROM-switching overhead no _ longer 
exists.) 


* Now, down to problems: 


* Some of you have experienced problems 
with INK, PAPER etc commands following 
disk operations (read' the letter from 
Trevor Judd for details). The reason is 
that these commands don't seem .to open 
the screen channel by default 
therefore the stream which was used last 
is assumed. Trying to handle a. screen 
command via the disk channel is 
definitely NOT the done thing! 
Fortunately, 'PRINT' automatically makes 
stream 2 and its attached channel the 
'current' stream and so using 'PRINT' 
(if you don't mind a line-feed) or 
'PRINT;' (if you do) will eliminate the 
problem. 


* TEC drives, usually supplied by 
Cumana, are very quiet and quite cheap. 
They can also be nasty and a bit 
unreliable. Some of them have the habit 
of —occasionally- letting their 


* Past newsletters are available fron 
us tor £2.00 post-paid for anywhere in 


Great Britain or US $5.00 for the rest 
of the world. 

* KDOS users who have managed to get 

. hold of Newsletters 1 and 2 must 


substitute the SPDOS addresses for KDOS 
addresses as follows: 


SPDOS KDOS 

#1420 #5D30 

#EAQO ۳605 

BABA replace the call by: 
CALL CEC 
RS? 1 8 

1 DEFB DOS error 0 077 
(eg #1B for "Record not found’ ete) 


The Hook Codes ('svc's) are the ۰ 


* The KDOS system uses 703 bytes 7 


PROG and therefore PROG has moved from 
23755 to (23755+703). 

* SOFTWARE ANNOUNCEMENTS * 
* Two of the best programs for the 


Spectrum that I have ever come across 
come from the OCP (Oxford Computer 
Publishing Ltd) stables: 


a. Full Screen Editor Assembler 
b. Art Studio 


The Assembler is an old favourite with 
superb editing facilities, FULL 
SPDOS/KDOS compatibility and is 
configurable to drive any one of 15 
printer interfaces (including of course 
our very own, the MOREX/WATFORD and now 
ABBEYDALE Centronics/bi-directional 
R9232 interface) 

The screen editor 
format and includes 


uses a 42 column 
many word-processing 


features like Bloc! Mark, Block Delete, 
Block Move, Block Copy, Global Search 


and Replace (fast!), Line and Character 
Tnsert/Delete/Change ete. 

Like Hisoft, James Hutchby of OCP, 6 
author of the Editor/Assembler, decided 
that SPDOS/KDOS is the only Disk System 
that actually ENHANCES his superb 
software and therefore, ne produced his 
disk version for it. 


vor example, 
PRIND #4 HELP" SAVE " 


could load a routine called 'H', parse 
che rest of the line to check that the 


ASCII codes for و۲۲‎ 'L' and 'P' are 
present and that a string expression 
follows. It would also check that no 
furtner parazeters are given. The 
program coulé then load a previously 
saved screen called ' SAVE ' describing 


tne 'SAVE' syntax, modes etc. A library 
of help pages دغه‎ be designed and then 
saved as sereern ana the 'HELP' command 
would selectively display any one of 
them. Loadin? the anoropriate screen can 
pe done 260070107 ‘so the instructions 
given مد‎ SURFaews2 on saving and loading 
CODE Tiles fron machine 0۰ 


To start you off here is تت‎ 43 
beginnings 
ORG 23296 ;printer buffer 
HELP RST #20;ne>t character 
CP p! 
JR 2,CONT 
ERR RSI! 8; ; Parameter error 
DEFB #19 
CONÎ RSI #20 ;next 
CP- SE 
JR رخا‎ GRR 
Roe ٩ #20 
cr 7 


JR NZ,uERR 


RST 0 spoint to string 
CALL /H1C8C;expect expression 
CALL #2048: Bad of line? 

JR NZ ERR 


CALL #2BM ; Fetch expression 
; low BC=lengih, 17 

XOR A ¿Clear A 

OR 3 :length>255? )١( 

JR H2, ERR 

ID A,C;length in A 

CP 11 :10 chars maximum 

. JR NC ERR 
sNext, zero-fill the DCB and: 

ID HL,DCBH Filename area 

EX DB, U 

LDIR 3 
sete ete etc. 
SAVE the code as 'H'. 


the string to it. 


HAVE FUN! 


‘clicked', the 'LOAD', 'SAVE',  'NERGE' 
. etc options are chosen and Rob's your 


Uncle! 
Needless to say this is another James 
Hutchby creation. When it is used with 


his Screen Compression routine it can 
produce screens that take as little as 
2k on disk! 
More information from: 
OCP 
772, Packhorse Rd, 
Gerrards Cross 
Bucks SLO SPQ 
Tel:(0753) 988866 
Art Studio has been licensed to BT's 
Firebird and they will. be re-launching 
it lster this year. OCP programs are 
also beginning to appear on Prestel in 
Micronet 800, whence they can be 
downloaded. These are not the disk 


versions, however. 


The utility reads the program (mst be 
in BASIC!) into memory and then searches 
through it for occurrences of tape 
and/or ` microdrive keywords. ‘hey are 
then replaced by the appropriate 'PRINT 
#4:' syntax including the 'PRINT 4d' 
drive specification and the double colon 
whenever necessary. Some tape '‘LOAD' 
cormands may be found with ۳۲ instead of 
a filename. These are flagged on the 
screen by printing the line number of 
the conmnand. Finally, the edited program 
saves itself on disk using the temporary 
filename "TIMP/BAS" which can then be 
renamed. When the command terminates, 
the BASIC program remains in memory so 
that the final touches can be put in 
manually. Occurrences of tape/microdrive 
'VERIFY' as well as ۱۲ are 
deleted. Microdrive sequential access 
filing is handled as well. by converting 
to SPDOS and if, as it sometimes 
happens, stream #4 is used in the normal 
sequential sease, it is replaced by #15. 
The utility was tested with two of the 


most complex microdrive-only business 
prograus, Transform's  'Sales/Purchase 


Ledger' and 'Invoicing'. The latter had 
a "LOAD "١١ command and the INK/PAPER 
ete problein I discussed at the beginning 
of this column. It was a matter of 


seconds to put them right manually. 
Considering the sheer size of these 
programs, complete compatability with 


SPDOS/KDOS was achieved with the minimum 
amount of work! © 


ج ما 27 


The Art Studio program, which made the 
headlines when it was launched at the 
last PCV Show in London, was written for 
SPDOS und KDOS and only later was a 
tape/microdrive version produced. It is 
very Similar to MacPaint (for the Apple 
iacintosh) in its use of pull-down 
menus, icons, windows etc. It can be 
driven from xeyboard, joystick or mouse 
and allows Screen creation and editing 
down to pixel level. Painting offers a 
choice of Brusnes, Spray Cans and Pens 


while Filling can be solid or Textured. 


(from a choice of textures). Fonts can 
be created, edited, saved and loaded and 
text can be placed on the screen in a 
variety of sizes and orientations. All 
functions including tne disk options are 


invoked simply by pointing at then with 
an arrow whien is controlled by 
joystick, mouse or cursor keys, then 
pressing a key or tae joystick or mouse 


fire~button. The disk operation reminds 


one of the GE? environment where 
filenanes are simply pointed at and 


ee er me‏ س مد 
نم تسس دص هوه ee a‏ شش re‏ 
A‏ 


* SPdos Utility Disk (Yes, SPUD!) 


Following the phenomenal success of the 
release of SPDOS Version 1.2, we have 
now prepared a Utilities Disk with lots 
of nice things on. I shall describe some 
of its features so far (as we keep 
putting more and more utilities on it!): 


a. Tape/Microdrive format to SPDOS: 


This is best used after the ۲ 
comand of V1.2 and KDOS. After a BASIC 
program has been transferred from tape 
to disk with all its protection retained 
it probably needs laborious editing to 
replace all the microdrive and/or tape 
commands with the correct SPDOS syntax. 
In some cases, the task is made more 
difficult by effective protection of the 
program. This need trouble you no more! 
This utility runs as a single character 
filename program and is of the form: 


PRINT #4'uxd, "filename" 


where, x=t if only tape commands are 
replaced, 
وما‎ if only microdrive commands 
are to be replaced تت‎ 
=b for both tape and microdrive 
commands. 
d is the drive number (1 to 4) 
"filename" is the name used by 'COPY' to 
put the program on disk. 


d. 42/51 colum driver 


* This Utility transforms the video 
display to 42 or 51 columns per line and 
is usable from both BASIC and machine 
code. The command format is: 


PRINT #4'Vn 


where n =O for 42 columns 
±1 for 51 columns. 


In order to fit it between the end of 
SPDOS's overlay buffer and the beginning 


of the ABBEYGRAP printer driver (MOREX) 
some sacrifices had to be made: Codes 


below ASCII 'Space' (20 Hex) ۳6د‎ 43 
and, therefore, 'AT', ‘WAB', 'TNVERSSE' 
ete are not being handled. Graphics and 
UDGs print spaces. Spectrum keywords are 


expanded into ASCII strings making 
'List' usable from BASIC. A 
non-serolling mode is available by 
clearing bit O of an unused system 
variable and thus HOMf#ing the cursor 
after the last character of the last 
line has been printed. This can be used 


in time-critical operations (RS232 input 
and output) where the SCROLL overhead is 
unacceptable. 

Once the driver has been initialised, 
411 output via stream 2 is processed by 
it. In machine code, RST #10 with stream 
2 open to the screen will print a 
character. 

Both options (42/51) have been used by 


us on the HISOFT GENS Assembler with 
encouraging success. 
e. POINT for random access 
The POINT command is used in 


conjunction with the existing sequential 
access facilities. A data file must 


exist before 'POINT' is used; it must 
consist of fixed length records with 


lengths adding up to 511 bytes. For 


example, the 511-byte buffer can consist 
of the following sub-records: 


aS(1) : Name 30 bytes 
ab(2) : Address 20 bytes 
a3(3) : Tom 20 8 
(4)غه‎ : County 20 bytes 

. a$(5) : Country 20 bytes 
a$(6) : Tel. no. 17 bytes 

۱ TOTAL 127 bytes 


Now, 511=4 x 127 + 3 


So four complete sub-records like this 
can be put on the buffer, leaving only 
three bytes unused, so therefore each 


b. Disk To Tape (All right! DDT!) 


* This Utility was written out of mere 
necessity in my efforts to speed up the 
duplication of "config" and “MFPRINI" 
tapes for SPDOS users. "config" consists 
of three BASIC programs and a machine 
code program. 'CODE' is no problem as, 
in this particular case, it can sit 
happily at the top of memory waiting for 
its turn to be saved for the n'th time. 
The BASIC programs however had to be 
loaded individually from disk EVERY time 
as they simply over-wrote each other. 

The following command was created: 


PRINT #4'Td, "filename"; 


where, d :drive number (1-4) 
; soptional. When used, you are 
prompted to press any key. 


eg ۱ 
10 PRINT #4'T1,"prog1"; :PRIN! #4", 
"prog2" : PRINT #4 ۱ T2; "prog" 


The three programs of the example can 
be BASIC or CODE. You are prompted at 
the bezinning to initialise the SAVE and 
they are then saved one after the other 
on tape. If you have a long enough tape 
entire disks can be backed up on tape 
for security by first putting all the 
filenames in a sequential file and then 
using string array elements in place of 
the 'T' command filename. Backup copies 
of your tape programs can easily be made 
by 'COPY'ing them on disk first and then 
‘Tl ing them back to tape. 


c. Modified CAT ('LIST') ` 


This utility is very useful when you 
want to find out where a program runs 
from or the exact parameters of a CODE 
file. 


The command format is: 
PRINT #4:LIST; PRINT d,"string" 


which is identical to the 'full' CAT 
syntax. 

It displays the start address and the 
exact length in hexadecimal (ie it does 
not round up to the nearest kilobyte) as 
well as the standard attributes 
(filetype and filename). 

BASIC programs saved with a LINE number 
are ahoum with this mmber as a start 


: 


O 


dM 


LANGUAGE .... L-BORTH ('79 with extns.) 
SYSTEJ .... SPECTRUM with backing store 
(any or all of cassette, microdrive, 
SPDOS/KDOS) plus printer (optional) 

TROT e... Francis GLASSBOROW, 64 SOUTH- 
FIELD ROAD, OXFORD, 0x4 1PA (27.00) 


WHAT IS FORTH .... If you already know 
what FORTH is then you can skip this bit 
but if not, then read on. For starters | 


you might be 211676851531 to xnov that 
FORNI was originally designed to help 
with the control of a radio telescope, 
and on the other hand has been used 
successfully for writing, adventure 
programs. That's some Jansuave!! FORTH 
consists of WORDS (there mizht well be 
two or three HUNDRED of them in a 


typical package). Documentation and 
description are made a تا‎ tricky since 
some of the words are very 7 and 
looi: like punctuation marks ( af 


You can use these small units to make 
new words of your om which do a bit 
more than the single words, then you 
combine your words and some more from 


the dictionary to maxe even more power- 
ul words ... and so on. You might be 
on more familiar ground with I" BISE 
THEN, DO .. LOOP and a CASE construction 
which are all supported in this imple- 
mentation. That bit sounds like a high 
level language, true enough, but at the 


‘other extreme you will have to come to 


terms with manipulating a stack and 
reverse polish notation (neither of 
which is particularly difficult if you 
get hold of a good bool). 


WHAT IS L-FORTH .... all of that and a 
lot more besides. I have discovered 
some powerful graphics words that make 
good use of the Spectrum; a wnole family 
of words to support debugging, including 
EXPAND. When you create words of your 
own (either directly at the keyboard or 


via an editor) they are compiled into 
the Dictionary and, unless your paper- 
work is better than mine, you will end 


up with bugged words and not a clue as 


to how you did it! EXPAND the word and 
all will be revealed (addresses, jumps, 
the lot). ‘his PORTH has THREE stacks, 


not just the usual two (DATA and RETURN) 
The third stack has been implemented to 
support true local variables and recur- 
sion, and would be invaluable to the 
more experience programmer for develop- 
ment of languages and databases. 


improved by 


INPUT! command can be made to read in 
four sub-records. ‘The 'POINT' command, 
which is of the form 'PRINT #4'POINT (b, 
n)' positions the file pointer to the 
nth 511-byte 'main' record: so that an 
7112011 command can read its sub-records. 
'b' corresponds to the buffer (stream) 
which is open for the file in question. 
You can move from one end of the file to 
he other without having to read the 
records in between. 'POINT' converts 
the data file to one open for both 
reading, and writing and a sequence like 
the following is possible: 


PRINT #4' POINT (5,50) 

INPUT #5; bô 

REM your provran modifies b$ 
PRIN? 45, b$ : REM update record 


A complete «demonstration program 
(similar ro MAIL/ZAS) is included on the 
utility disk where a number of random 
access techniques are shown. 


f. DUMP 


Complete CODE files are ۰ loaded from 
disk and their contents printed on: the 
screen or printer aS a ‘formatted 
hexadecimal and ASCII. dump. The 
displayed addresses can start at a user- 
defined point or default to the address 
from which the file was: originally 
saved. The display can be 
loading the 42/51 colum driver before- 
hand. 


g. FORTH 79, FP. Glassborrow's Forth 


You have heard a lot about 57 
Forth implementation and its SPDOS 
version. It is a very impressive piece 
of software and is reviewed in this 
SURFnevs. Francis has let us put his 
Torth on the SPUD (!) disk but 6 
retains the copyrisht and the right to 
sell you his -very-- comprehensive manual 
for 6. It is well worth it! 


“he disk with these items is available 
from Abbeydale Designers for 230 or $60. 
he same disk also comes as a full SPDOS 
v1.2 system disk with the additional 
feature of a copiable ‘'copysys' and 
FORMAT so that copies of masters are how 
possible. If you already have SPDOSv1.2 
then send that disk back to Abbeydale 
with £15 (%30) only for this new 
yersion. 


cassette to provide a back-up. A double 
key-press in the EDITOR and you have 
marked a block as updated. This can be 
FLUSHed with a single key press or sent 
out to backing store if you LOAD more 


screens into the EDITOR. You can abort 
these operations if you change your 
mind. Obviously with SPDOS the whole 
system works more quickly; with up to 


800 screens on a side of a disk you have 
huge power and flexibility! 


A very thorough document 
It contains an 
the dictionary 


SUPPORT .... 
accompanies L-FORTH. 
annotated list of all 
words available to you. They are very 
carefully classified so that you 7 
which are the FORTH 79 words (important 
if you want to keep your code portable), 
which are system words and so on. There 
is a great deal of information about the 
implementation of which you can make 
more use when you know the system better 
and a quantity of advice and help. It 
can be a bit difficult to read at times 
but it's all in there ... somewhere. If 
you get stuck, need a modification or 
ean't work out how to do something in 
particular then pop it in the post (sae, 
please) and if there is an answer you 
will have it trom Francis. He even goes 
so far as to suzvest that if all else 
fails he will offer you a recompilation 
of his source code (with your modifica- 
tions) for a reasonable fee. He is a 
real enthusiast who has devoted a large 
part of the last three summers to this 
project. You and I can benefit from his 
labours for the paltry sum of £1.00 for 
a cassette version ready to load onto 
disk and £6.00 for the documentation and 
support (please add £1.50 if you want 
the things sent outside the UK). Or you 
can have the code on disk with the 
latest SPUD (see elsewhere in this news- 
letter). 
VERDICT ... Niggles? Yes 
Problems? Yes 
Pleased? DELIGHTED!!! 

I liked it a lot, and so will you. In 
fact I like it so much that I an 
starting a Users' Group. The main 
feature will be a newsletter (about six 
a year), the first issue coming out in 
the spring. If you are interested then 
drop me a line (with a cheque for 0 
for your fist year's sub. if you like). 

I am Peter Baker, 35 Hazel Drive, 
Woodley, Reading, Berks, RG5 3SA, UK. 


THE EDITOR (ZED) .... every FORTH needs 
one so . Francis Glassborow decided ۰ to 
chuck cut the.standard offering with. its 
fixed line length and tiresome ورزر‎ 
based editing and go right back to the 
drawing board. The result is an 
impressive screen-based EDITOR which is 
so powerful that it will probably take 
you several weeks to find out the full 
extent of its capabilities. Of course 
there are niggles here and there over 
things that I might have done differ- 
ently (nad I known how, that is!), but 
all in all it's a splendid tool and one 
that I can easily live with. 


BACKING STORE .... Originally FORTH used 
a virtual memory. When it was desismed, 
hardware (memory in particular) was very 
expensive so the source code was 0 
via two buffers to a backing store. By 
typing د ه)‎ ( 17 LOAD you would instruct 
the compiler to find SCREEN 17 in the 
backing store, load it and compile the 
words straight into the Dictionary. With 
(e.g.) 100k available on disk you could 
store and compile 100k of source code 
into compact iMRTH words which would 
need but a tiny fraction of that space. 
When the languaze was implemented. for 
our beloved micros one of two things 
happened: (a) the system was copied 
exactly and the hapless cassette user 
had to load one screen at a time or (b) 
an area of the available RAM was desig- 
nated as a DISK and several screens 
could than be loaded into this area in 
one go. My first FORTH was like. that 
and it worked well, but the concept of 
an unlimited virtual memory was lost. 
“Now it is back, thanks to Francis’ 
efforts. He has designed a system which 
behaves satisfactorily with a cassette 
recorder and magnificently with either 
microdrive or dist (SPDOS/KDOS). 


BLOCKS, SCREENS AND THE VIRTUAL MEMORY - 
1 BLOCK = 512 BYTES, 2 BLOCKS = 1 SCREEN 
The size of the backing store is limited 
only by the size of your storage system. 
There is room on & single microdrive for 
more than 70 screens (Francis can get 99 
or more using a special technique!) so 
if you run two. drives you have an appar- 


ent RAM of more than 150k divided into. 


mumbered screens. These can be compiled 
straight from the backing store or 
loaded in to the EDITOR, which has room 
for 5k of source code. Blocks of five 
consecutive screens can be dumped to 


Dave Fertmhorough replies: The SPOS 
systen for the 2068 and the Spectrum 6 
different in both hardware and sortware 
although there is a sreat deal of 
compatibility at the user level. It 
would be cossible to produce a version 
of the Spectrum software that would work 
with the 2068 hardware. However, I 
could not test such a system as I do not 
have a ROMswitch for my 2068. Also we 
would regard this as a “special” and 


would have to charge something like: $75 
for a master disc because of the work 
involved in producing it. If you are 


prepared to pay that amount and taxe a 
risk on its workin, then I'll be pleased 


to produce such a disk for you. There 
should be no problen in using د‎ disk 
version of the system provided it is 


desisned for the correct combination of 
hardware and software. 


Dear Sir, 


I followed your instructions ۳ 


customising the Tasman B printer inter- 
face for use with SPDOS. However, when 


the Tasman interface is hooked up to the 
Westridge 2050 modem the characters 
types in from the keyboard do not agree 
with what's displayed on the screen in 
terminal mode. The receiving computer 
can apparently understand what's typed 
in because I don't have any problems 
logging on to the Compuserve netvor. 
Is there any way to fix this problem? 


Dave replies: I am not familiar with 
the Westridge modem and therefore cannot 


answer your query concerning, the 
different characters. It may be worth 
contacting RAMEX to see if they have a 
solution. Has any. SURF member any 
ideas? 


Dear Mr Farmborough, 

It was certainly interesting to read 
the number. 2 newsletter describing a 
method of obtaining disk versions of 
cassette prosraias which conflict with 
the needs of SPDOS. I had already 
realised that this vas probably the only 
reasonable way to proceed, but receipt 
of the newsletter at the time I was 
about to start experimenting actually 
saved me a lot of effort. 

Yours sincerely, 
Ken Rendall 


a local 


THE THINGS YOU WRITE!! 


Dear Desimers, 

A manual of machine code calls to DOS 
and their requirements would be a great 
item to add to your line. I know that I 
would buy one in a flash. I realise the 
information will be leaked out 11 the 
Newsletter (which is fabulous) but I am 
interested in writing machine code 
applications based on your DOS. My real 
interest at present is writing a shell 
that wold allow tree directories. i 

I enclose a pro“ram listing to create 
Tasword-compatible files from disassemb- 
led output from HOT û to enable adequate 
documentation of assembly language 
programs using the 12-2063 [see separate 
articie in this newsletter]. 

I an interested in forming 
users' group here in the United States. 
Are you interested in making announce~ 
nentes about local users' groups in your 
newsletter [yes ~ Julian, your. 1۰ 
This could prove a boon to getting 
sroups started as the publications in 
this country that are dedicated to 
Sinclair products and third-party 
support are in meager supply. 

Sincerely, 
ifumson H. Cockayne, Jr. 342 Trotter 
Court, Sandford, 1107133 32771, U.S.A. 
[Write direct to Munson if. you want to 
form a group along tne lines he suggests 
and its activities will be reported in 


SURFnews ( 


Dear Sirs, 

.Our computers in North America are 
the TS-2068, a version of the Spectrum, 
as you may Imow. Many of us have ROM- 
switches installed which convert the 
machine into a Spectrum so that we can 
run Spectrum programs. In fact, most of 
us run exclusively in Spectrum mode. Is 
a Spectrum version of SPDOS software 
available and if so is it avdilable on 
cassette and if so at. wnat price’ 

The reason for wanting a cassette 
version is that the hardware interface 
is designed to auto-boot on the TS-2068 
ut does not do so in Spectrum mode -due 
to ROM differences. You would therefore 
have to load SPDOS via cassette and use 
the drive after that. As most of my 
programs are Spectrum this would seem to 
be my only solution. 

Sincerely, 
R. Halder (Quebec; Canada) 


How about this one? 


25 PRIND {4: LOAD "test" 


100 PRINT #4. SAVE "testload" 
The above is used to load: 


10 REM 
20 REM 
30 REM 
40 REM 
100 PRINT #4: SAVE "test" 
Result: C Nonsense in BASIC, 25:2 


This time the نبا‎ PRINT’ trick has no 
effect. Comments? 


Here's a small tweak if you use onnicale 


2 with Kempston 1 Unlike 
tasword and Masterrile, having, entered 
23370 as the printer driver address 
using option G of function X, the 
customised version cannot be saved 
easily. Using the following: initial 


program load routine, an unconditional 


jump to 23370 is poked to 65045. This 
is the address that omicale2 looks at 
for a print driver rotine if you 
haven't given it an address. Lines 20 
and 30 apply to Epson printers. For 
other printers refer to the Kempston 
instructions and extract data fron the 
relevant routine. 

10 REM TeeileeSoft SPDOS AULO/OMNI 

20 OUT 58303,129: OUT 58303,15. LET a= 
PEEK 23631; LET b=PEEK 23032. LET c=at 


256*b4+15; POKE c,0: POKE c+1,91 

30 PRINT #4: LOAD “epsonhre"CODE 

40 POKE 25511,204: REM SPDOS 1.1 patch 
see SURMews!. Not needed for SPDOS 1.2 


or DOS 

50 POKE 65045, 195. POKE 65045, 74 POKE 
65047, 91 

60 PRINT #4: LOAD “onmicalc2" 

70 STOP 

100 PRINT -#4: SAVE "AUTO"LINE 10 
Use GOTO 100 to SAVE the routine. Check 
CAT for AUTO, epsonhre, onmicale2, OMNI/ 


DAT and OMNI/ WORK. 
Finally I think it vould 


be useful to 


distribute 2 list of SURF members who 
would like to comunicate with each 
other. We could then pass ideas around 
and develop them before the next News- 
letter. 


Yours sincerely, 
Trevor Judd 


Dear Julian, 
Humble apologies fron yours truly. I 
received SURFnews2 but the pleasure of 
d 


seeing my name in print rapidly fade 
when I read of the trouble you 
experienced in putting "Hobbit" on to 


22903. The problem was not difficult to 
spot and was due entirely to my trying 
to learn how to drive tasword while 
5 5 د‎ 
composing the article. (My excuse and 
I'm sticking to iti!) 
The lack of a CLEAR command in step 8 


is the first problen. But there are 
wore where that came from. In the 
routine “ldir”, line 40 fouls up code 


block 2 by writing to the display file 
while it is being used as a bufer and 
the data in line 50 uses the code block 
adjresses that I ased in the original 
mdos version. Wot wood, is it! Fix as 
follows: 


tep 6 and 7 reversed 

tep 3 - Reset SPDOS and CLEAR 24575 

tep 11 line 20 PRINT "Start tape at ۳ 
delete line 40 
line 50 DATA 33,16,64,17,0,226,1 
, ,2ر425‎ 601 

Step 11.1 RUN “ldir" 

Step 12 SAVE "hobbit" line 5 

Step 13 add "hlozo” 


And nov a probiea I have discovered 
while transferriiv; the Horizons eassette 
to disc. Having changed the LOAD 
commands for dist operation the problems 
started. The desired program loads OK 
but when it runs display commands appear 
to be interpreted as DOS commands. 6 
following examples produce the results 
quoted i 

۹ PRINT #4. TOAD "lLogo"CODE 

20 PAPER 7 
Resuli. © Nonsense in BASIC, 20:1 


1C PRINT #4: LOAD “Logo"CODE 

20 PAPER 7: INX O 

Result: Y Illegal command, 20:2 

10 PRINT #4: LOAD "logo"CODE : PRINT 
20 PAPER 7: INK ۵ 

Result: OK. 20.2 


The double colon PRINT expression does 
tne trick but means that conversion of 
the Horizons programs is aot as straight 
forward as it might be. [see 1 ۵ 
colum for a bit more on this problem] 


